<!DOCTYPE html>
<html lang="en-US">
    <head>
        <title>String::Approx - Perl extension for approximate matching (fuzzy matching) - metacpan.org</title>
        <link rel="preload" as="fetch" href="https://metacpan.org/account/login_status" crossorigin="anonymous" />
        <link href="https://metacpan.org/_assets/b8ccceeed47a0652049703d99326a9cea4933443.css" rel="stylesheet" type="text/css">
        <script src="https://metacpan.org/_assets/6bfedafe2d7caa915b7d84f61b45936818e3242e.js" type="text/javascript" defer></script>
        <link rel="alternate" type="application/rss+xml" title="Recent CPAN Uploads of String-Approx - MetaCPAN" href="https://metacpan.org/dist/String-Approx/releases.rss" />
        <link rel="canonical" href="./String::Approx.html" />
        <meta name="description" content="Perl extension for approximate matching (fuzzy matching)" />
        <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=5">
        <link rel="shortcut icon" href="https://metacpan.org/static/icons/favicon.ico">
        <link rel="apple-touch-icon" sizes="152x152" href="https://metacpan.org/static/icons/apple-touch-icon.png">
        <link rel="search" href="https://metacpan.org/static/opensearch.xml" type="application/opensearchdescription+xml" title="MetaCPAN">
        <script>
          (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
          (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
          m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
          })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

          (function(skey, ga_id){
            ga('create', ga_id, {
              siteSpeedSampleRate : 100,
              storage             : 'none',
              clientId            : localStorage.getItem(skey)
            });
            ga(function(tracker) {
              localStorage.setItem(skey, tracker.get('clientId'));
            });
            ga('send', 'pageview');
          })('ga:clientId', 'UA-27829474-1');
        </script>
<meta name="twitter:card"        content="summary" />
<meta name="twitter:url"         content="https://metacpan.org/pod/String::Approx" />
<meta name="twitter:title"       content="String::Approx" />
<meta name="twitter:description" content="Perl extension for approximate matching (fuzzy matching)" />
<meta name="twitter:site"        content="metacpan" />
    </head>
    <body>
        <nav class="navbar navbar-default" role="navigation">
            <div class="header-logo-large hidden-xs">
              <a href="https://metacpan.org/" tabindex="0">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#logo" />
                </svg>
              </a>
            </div>
            <div class="header-logo-icon visible-xs">
              <a href="https://metacpan.org/">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#dots" />
                </svg>
              </a>
            </div>
            <ul class="nav navbar-nav menu-items hidden-xs hidden-sm">
              <li><a href="https://metacpan.org/about">About</a></li>
              <li><a href="https://metacpan.org/about/sponsors">Sponsor</a></li>
              <li><a href="https://grep.metacpan.org/">grep::cpan</a></li>
              <li><a href="https://metacpan.org/recent">Recent</a></li>
              <li><a href="https://metacpan.org/about/faq">FAQ</a></li>
              <li><a href="https://metacpan.org/tools">Tools</a></li>
              <li><a href="https://fastapi.metacpan.org/">API</a></li>
            </ul>
            <ul class="nav navbar-nav navbar-right">
                <button type="button" class="searchbar-btn visible-xs visible-sm">
                    <i class="fa fa-search button-fa-icon"></i>
                </button>
                <form action="https://metacpan.org/search" class="searchbar-form visible-md visible-lg search-form form-horizontal">
                   <input type="hidden" name="size" id="metacpan_search-size" value="20">
                  <div class="form-group">
                      <div class="search-group">
                        <i class="fa fa-search"></i>
                        <input type="text" name="q" placeholder="Search the CPAN" size="41" autocorrect="off" autocapitalize="off" spellcheck="false" id="metacpan_search-input" class="form-control" value="">
                      </div>
                  </div>
                </form>
                    <li class="icon-slidepanel visible-xs visible-sm">
                      <button data-toggle="slidepanel" data-target=".slidepanel">
                        <span class="button-fa-icon">
                          <i class="fa fa-bars slidepanel-open"></i>
                          <i class="fa fa-times slidepanel-close"></i>
                        </span>
                      </button>
                    </li>
                <form action="https://metacpan.org/account/logout" method="POST" id="metacpan-logout"></form>
                <li class="dropdown logged_in" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon logged-in-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li><a href="https://metacpan.org/account/identities">Identities</a></li>
                        <li><a href="https://metacpan.org/account/profile">Profile</a></li>
                        <li><a href="https://metacpan.org/account/favorite/list">Favorites</a></li>
                        <li>
                            <a href="./String::Approx.html#" type="button" onclick="$('#metacpan-logout').submit(); return false">
                              Logout
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_out" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li>
                            <a href="https://metacpan.org/login/github">
                                <i class="fab fa-github fa-fw"></i>
                                GitHub
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/twitter">
                                <i class="fab fa-twitter fa-fw"></i>
                                Twitter
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/google">
                                <i class="fab fa-google fa-fw"></i>
                                Google
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_placeholder">
                    <button>
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                    </button>
                </li>
            </ul>
        </nav>
        <div class="page-content ">
          <!--
          <div class="top-notify-banner">
            <i class="fas fa-info-circle"></i>
          </div>
          -->
          <nav class="sidebar">
            <div class="slidepanel">
              <ul class="nav-list ">
    <li class="nav-header no-margin-top">
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The date that this version of String-Approx was released.">
      <span class="relatize">16 Apr 2017 08:52:13 UTC</span>
    </li>
  <li>
    Distribution: <a href="https://metacpan.org/dist/String-Approx">String-Approx</a>
  </li>
  <li>
    Module version: 3.28
  </li>
  <li>
    <a data-keyboard-shortcut="g s" href="https://metacpan.org/dist/String-Approx/source/Approx.pm">Source</a>
    (<a href="https://metacpan.org/dist/String-Approx/source/Approx.pm?raw=1">raw</a>)
  </li>
  <li>
    <a data-keyboard-shortcut="g b" href="https://metacpan.org/dist/String-Approx/source">Browse</a>
    (<a href="https://metacpan.org/dist/String-Approx/source?raw=1">raw</a>)
  </li>
    <li>
      <a data-keyboard-shortcut="g c" href="https://metacpan.org/dist/String-Approx/changes">Changes</a>
    </li>
    <li>
      <a class="nopopup" href="https://metacpan.org/dist/String-Approx/contribute">How to Contribute</a>
    </li>
    <li>
      <a rel="noopener nofollow" data-keyboard-shortcut="g i" href="https://rt.cpan.org/Public/Dist/Display.html?Name=String-Approx">Issues</a>
      (5)
    </li>
    <li>
      <a rel="noopener nofollow" href="http://matrix.cpantesters.org/?dist=String-Approx+3.28" title="Matrix">Testers</a>
        <span title="(pass / fail / na)">(<a rel="noopener nofollow" href="https://www.cpantesters.org/distro/S/String-Approx.html?oncpan=1&amp;distmat=1&amp;version=3.28&amp;grade=2" style="color: #090">186</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/S/String-Approx.html?oncpan=1&amp;distmat=1&amp;version=3.28&amp;grade=3" style="color: #900">0</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/S/String-Approx.html?oncpan=1&amp;distmat=1&amp;version=3.28&amp;grade=4">0</a>)</span>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpants.cpanauthors.org/release/JHI/String-Approx-3.28">Kwalitee</a>
    </li>
    <li>
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The # people with an indexing permission on String-Approx who have released something to CPAN in the last 2 years (i.e. the # people likely able to release critical fixes in a timely manner)">
      Bus factor: 0
      </div>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpancover.com/latest/String-Approx-3.28/index.html">68.44% Coverage </a>
    </li>
    <li>
      License: unknown
    </li>
    <li class="nav-header">Activity</li>
    <li>
<div class="activity-graph">
    <img src="https://metacpan.org/dist/String-Approx/activity.svg?res=month" />
    <div class="comment">24 month</div>
</div>
    </li>
    <li class="nav-header">Tools</li>
    <li>
      <a itemprop="downloadUrl" href="https://cpan.metacpan.org/authors/id/J/JH/JHI/String-Approx-3.28.tar.gz">
      Download (<span itemprop="fileSize">44.04KB</span>)</a>
    </li>
    <li>
      <a href="https://explorer.metacpan.org/?url=%2Fmodule%2FJHI%2FString-Approx-3.28%2FApprox.pm">
        MetaCPAN Explorer
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/String-Approx/permissions">
        Permissions
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/String-Approx/releases.rss">
        Subscribe to distribution
      </a>
    </li>
    <li>
      <button class="btn btn-link" data-toggle="modal" data-target="#metacpan_install-instructions-dialog">
        Install Instructions
      </button>
    </li>
    <li>
      <form action="https://metacpan.org/search">
        <input type="hidden" name="q" value="dist:String-Approx">
        <input type="search" name="q" placeholder="Search distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
      </form>
    </li>
    <li>
      <form action="https://grep.metacpan.org/search">
        <input type="hidden" name="qd" value="String-Approx">
        <input type="hidden" name="source" value="metacpan">
        <input type="search" name="q" placeholder="grep distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
     </form>
    </li>
    <li class="version-jump">
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/Approx.pm&#39;" class="form-control tool-bar-form">
  <option disabled selected>Jump to version</option>
<option
  disabled
  value="JHI/String-Approx-3.28"
>3.28
  (JHI on 2017-04-16)</option>
<option
  
  value="JHI/String-Approx-3.27"
>3.27
  (JHI on 2013-01-22)</option>
<option
  
  value="JHI/String-Approx-2.7"
>2.7
  (JHI on 1998-03-23)</option>
<option
  
  value="JHI/String-Approx-1.6"
>1.6
  (JHI on 1997-04-13)</option>
<optgroup label="BackPAN">'
<option
  
  value="JHI/String-Approx-3.26"
>3.26
  (JHI on 2006-04-09)</option>
<option
  
  value="JHI/String-Approx-3.25"
>3.25
  (JHI on 2005-05-24)</option>
<option
  
  value="JHI/String-Approx-3.24"
>3.24
  (JHI on 2005-01-02)</option>
<option
  
  value="JHI/String-Approx-3.23"
>3.23
  (JHI on 2003-12-01)</option>
<option
  
  value="JHI/String-Approx-3.22"
>3.22
  (JHI on 2003-10-19)</option>
<option
  
  value="JHI/String-Approx-3.20"
>3.20
  (JHI on 2003-05-12)</option>
<option
  
  value="JHI/String-Approx-3.19"
>3.19
  (JHI on 2002-08-18)</option>
<option
  
  value="JHI/String-Approx-3.18"
>3.18
  (JHI on 2001-10-16)</option>
<option
  
  value="JHI/String-Approx-3.17"
>3.17
  (JHI on 2001-08-03)</option>
<option
  
  value="JHI/String-Approx-3.16"
>3.16
  (JHI on 2001-06-28)</option>
<option
  
  value="JHI/String-Approx-3.15"
>3.15
  (JHI on 2001-02-10)</option>
<option
  
  value="JHI/String-Approx-3.14"
>3.14
  (JHI on 2000-11-16)</option>
<option
  
  value="JHI/String-Approx-3.13"
>3.13
  (JHI on 2000-09-06)</option>
<option
  
  value="JHI/String-Approx-3.12"
>3.12
  (JHI on 2000-04-30)</option>
<option
  
  value="JHI/String-Approx-3.11"
>3.11
  (JHI on 2000-04-24)</option>
<option
  
  value="JHI/String-Approx-3.10"
>3.10
  (JHI on 2000-04-18)</option>
<option
  
  value="JHI/String-Approx-3.09"
>3.09
  (JHI on 1999-07-19)</option>
<option
  
  value="JHI/String-Approx-3.08"
>3.08
  (JHI on 1999-06-23)</option>
<option
  
  value="JHI/String-Approx-3.06"
>3.06
  (JHI on 1999-06-16)</option>
<option
  
  value="JHI/String-Approx-3.04"
>3.04
  (JHI on 1998-12-17)</option>
<option
  
  value="JHI/String-Approx-3.03"
>3.03
  (JHI on 1998-12-16)</option>
<option
  
  value="JHI/String-Approx-3.02"
>3.02
  (JHI on 1998-12-15)</option>
<option
  
  value="JHI/String-Approx-3.01"
>3.01
  (JHI on 1998-12-15)</option>
<option
  
  value="JHI/String-Approx-2.6"
>2.6
  (JHI on 1998-03-22)</option>
<option
  
  value="JHI/String-Approx-2.5"
>2.5
  (JHI on 1998-03-15)</option>
<option
  
  value="JHI/String-Approx-2.4"
>2.4
  (JHI on 1998-03-09)</option>
<option
  
  value="JHI/String-Approx-2.3"
>2.3
  (JHI on 1998-02-25)</option>
<option
  
  value="JHI/String-Approx-2.2"
>2.2
  (JHI on 1997-09-17)</option>
<option
  
  value="JHI/String-Approx-2.1"
>2.1
  (JHI on 1997-05-28)</option>
<option
  
  value="JHI/String-Approx-2.0_01"
>2.0_01 DEV
  (JHI on 1997-05-04)</option>
<option
  
  value="JHI/String-Approx-2.0"
>2.0
  (JHI on 1997-05-02)</option>
<option
  
  value="JHI/String-Approx-1.5"
>1.5
  (JHI on 1995-11-02)</option>
</optgroup>
</select>
    </li>
    <li class="version-diff">
<select onchange="document.location.href='/release/JHI/String-Approx-3.28/diff/' + encodeURIComponent(this.value) + '/Approx.pm'
" class="form-control tool-bar-form">
  <option disabled selected>Diff with version</option>
<option
  disabled
  value="JHI/String-Approx-3.28"
>3.28
  (JHI on 2017-04-16)</option>
<option
  
  value="JHI/String-Approx-3.27"
>3.27
  (JHI on 2013-01-22)</option>
<option
  
  value="JHI/String-Approx-2.7"
>2.7
  (JHI on 1998-03-23)</option>
<option
  
  value="JHI/String-Approx-1.6"
>1.6
  (JHI on 1997-04-13)</option>
<optgroup label="BackPAN">'
<option
  
  value="JHI/String-Approx-3.26"
>3.26
  (JHI on 2006-04-09)</option>
<option
  
  value="JHI/String-Approx-3.25"
>3.25
  (JHI on 2005-05-24)</option>
<option
  
  value="JHI/String-Approx-3.24"
>3.24
  (JHI on 2005-01-02)</option>
<option
  
  value="JHI/String-Approx-3.23"
>3.23
  (JHI on 2003-12-01)</option>
<option
  
  value="JHI/String-Approx-3.22"
>3.22
  (JHI on 2003-10-19)</option>
<option
  
  value="JHI/String-Approx-3.20"
>3.20
  (JHI on 2003-05-12)</option>
<option
  
  value="JHI/String-Approx-3.19"
>3.19
  (JHI on 2002-08-18)</option>
<option
  
  value="JHI/String-Approx-3.18"
>3.18
  (JHI on 2001-10-16)</option>
<option
  
  value="JHI/String-Approx-3.17"
>3.17
  (JHI on 2001-08-03)</option>
<option
  
  value="JHI/String-Approx-3.16"
>3.16
  (JHI on 2001-06-28)</option>
<option
  
  value="JHI/String-Approx-3.15"
>3.15
  (JHI on 2001-02-10)</option>
<option
  
  value="JHI/String-Approx-3.14"
>3.14
  (JHI on 2000-11-16)</option>
<option
  
  value="JHI/String-Approx-3.13"
>3.13
  (JHI on 2000-09-06)</option>
<option
  
  value="JHI/String-Approx-3.12"
>3.12
  (JHI on 2000-04-30)</option>
<option
  
  value="JHI/String-Approx-3.11"
>3.11
  (JHI on 2000-04-24)</option>
<option
  
  value="JHI/String-Approx-3.10"
>3.10
  (JHI on 2000-04-18)</option>
<option
  
  value="JHI/String-Approx-3.09"
>3.09
  (JHI on 1999-07-19)</option>
<option
  
  value="JHI/String-Approx-3.08"
>3.08
  (JHI on 1999-06-23)</option>
<option
  
  value="JHI/String-Approx-3.06"
>3.06
  (JHI on 1999-06-16)</option>
<option
  
  value="JHI/String-Approx-3.04"
>3.04
  (JHI on 1998-12-17)</option>
<option
  
  value="JHI/String-Approx-3.03"
>3.03
  (JHI on 1998-12-16)</option>
<option
  
  value="JHI/String-Approx-3.02"
>3.02
  (JHI on 1998-12-15)</option>
<option
  
  value="JHI/String-Approx-3.01"
>3.01
  (JHI on 1998-12-15)</option>
<option
  
  value="JHI/String-Approx-2.6"
>2.6
  (JHI on 1998-03-22)</option>
<option
  
  value="JHI/String-Approx-2.5"
>2.5
  (JHI on 1998-03-15)</option>
<option
  
  value="JHI/String-Approx-2.4"
>2.4
  (JHI on 1998-03-09)</option>
<option
  
  value="JHI/String-Approx-2.3"
>2.3
  (JHI on 1998-02-25)</option>
<option
  
  value="JHI/String-Approx-2.2"
>2.2
  (JHI on 1997-09-17)</option>
<option
  
  value="JHI/String-Approx-2.1"
>2.1
  (JHI on 1997-05-28)</option>
<option
  
  value="JHI/String-Approx-2.0_01"
>2.0_01 DEV
  (JHI on 1997-05-04)</option>
<option
  
  value="JHI/String-Approx-2.0"
>2.0
  (JHI on 1997-05-02)</option>
<option
  
  value="JHI/String-Approx-1.5"
>1.5
  (JHI on 1995-11-02)</option>
</optgroup>
</select>
    </li>

    <li>
<ul class="dependencies">
  <li class="nav-header">Dependencies</li>
  <li><a href="https://metacpan.org/pod/Test::More" title="Test::More" class="ellipsis">Test::More</a></li>
  <li><i class="ttip" title="dynamic_config enabled">and possibly others</i></li>
  <li>
    <hr>
  </li>
  <li>
    <a href="https://metacpan.org/module/String::Approx/requires">Reverse dependencies</a>
  </li>
  <li>
    <a href="http://deps.cpantesters.org/?module=String%3A%3AApprox">CPAN Testers List</a>
  </li>
  <li>
    <a href="https://cpandeps.grinnz.com/?dist=String-Approx">Dependency graph</a>
  </li>
</ul>
    </li>
    <li class="nav-header">Permalinks</li>
    <li>
      <a href="https://metacpan.org/release/JHI/String-Approx-3.28/view/Approx.pm">This version</a>
    </li>
    <li>
      <a href="./String::Approx.html">Latest version</a>
    </li>
    <li>
<div class="plussers">
<div class="nav-header">++ed by:</div>
<div>
<a class="display-all" href="https://metacpan.org/author/SREZIC"><img src="https://www.gravatar.com/avatar/5fa5a4e5ffdf883a1fcb1840c915d485?d=identicon&amp;s=20" title="SREZIC" alt="SREZIC"></a>
</div>
<!-- Display counts of plussers-->
<div>
    <a href="https://metacpan.org/dist/String-Approx/plussers">1 PAUSE user</a>
</div>
<div>
    3 non-PAUSE users
</div>
</div>
    </li>
    <li>
    </li>
              </ul>
            </div>
          </nav>
          <div class="content-navigation">
<div class="breadcrumbs">
  <span>
    <a data-keyboard-shortcut="g a" rel="author" href="https://metacpan.org/author/JHI" class="author-name">Jarkko Hietaniemi</a>
  </span>
  <span>&nbsp;/&nbsp;</span>
  <div class="release dist-release status-latest maturity-released">
    <span class="dropdown"><b class="caret"></b></span>
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/Approx.pm&#39;" class="">
<option
  selected
  value="JHI/String-Approx-3.28"
>3.28
  (JHI on 2017-04-16)</option>
<option
  
  value="JHI/String-Approx-3.27"
>3.27
  (JHI on 2013-01-22)</option>
<option
  
  value="JHI/String-Approx-2.7"
>2.7
  (JHI on 1998-03-23)</option>
<option
  
  value="JHI/String-Approx-1.6"
>1.6
  (JHI on 1997-04-13)</option>
<optgroup label="BackPAN">'
<option
  
  value="JHI/String-Approx-3.26"
>3.26
  (JHI on 2006-04-09)</option>
<option
  
  value="JHI/String-Approx-3.25"
>3.25
  (JHI on 2005-05-24)</option>
<option
  
  value="JHI/String-Approx-3.24"
>3.24
  (JHI on 2005-01-02)</option>
<option
  
  value="JHI/String-Approx-3.23"
>3.23
  (JHI on 2003-12-01)</option>
<option
  
  value="JHI/String-Approx-3.22"
>3.22
  (JHI on 2003-10-19)</option>
<option
  
  value="JHI/String-Approx-3.20"
>3.20
  (JHI on 2003-05-12)</option>
<option
  
  value="JHI/String-Approx-3.19"
>3.19
  (JHI on 2002-08-18)</option>
<option
  
  value="JHI/String-Approx-3.18"
>3.18
  (JHI on 2001-10-16)</option>
<option
  
  value="JHI/String-Approx-3.17"
>3.17
  (JHI on 2001-08-03)</option>
<option
  
  value="JHI/String-Approx-3.16"
>3.16
  (JHI on 2001-06-28)</option>
<option
  
  value="JHI/String-Approx-3.15"
>3.15
  (JHI on 2001-02-10)</option>
<option
  
  value="JHI/String-Approx-3.14"
>3.14
  (JHI on 2000-11-16)</option>
<option
  
  value="JHI/String-Approx-3.13"
>3.13
  (JHI on 2000-09-06)</option>
<option
  
  value="JHI/String-Approx-3.12"
>3.12
  (JHI on 2000-04-30)</option>
<option
  
  value="JHI/String-Approx-3.11"
>3.11
  (JHI on 2000-04-24)</option>
<option
  
  value="JHI/String-Approx-3.10"
>3.10
  (JHI on 2000-04-18)</option>
<option
  
  value="JHI/String-Approx-3.09"
>3.09
  (JHI on 1999-07-19)</option>
<option
  
  value="JHI/String-Approx-3.08"
>3.08
  (JHI on 1999-06-23)</option>
<option
  
  value="JHI/String-Approx-3.06"
>3.06
  (JHI on 1999-06-16)</option>
<option
  
  value="JHI/String-Approx-3.04"
>3.04
  (JHI on 1998-12-17)</option>
<option
  
  value="JHI/String-Approx-3.03"
>3.03
  (JHI on 1998-12-16)</option>
<option
  
  value="JHI/String-Approx-3.02"
>3.02
  (JHI on 1998-12-15)</option>
<option
  
  value="JHI/String-Approx-3.01"
>3.01
  (JHI on 1998-12-15)</option>
<option
  
  value="JHI/String-Approx-2.6"
>2.6
  (JHI on 1998-03-22)</option>
<option
  
  value="JHI/String-Approx-2.5"
>2.5
  (JHI on 1998-03-15)</option>
<option
  
  value="JHI/String-Approx-2.4"
>2.4
  (JHI on 1998-03-09)</option>
<option
  
  value="JHI/String-Approx-2.3"
>2.3
  (JHI on 1998-02-25)</option>
<option
  
  value="JHI/String-Approx-2.2"
>2.2
  (JHI on 1997-09-17)</option>
<option
  
  value="JHI/String-Approx-2.1"
>2.1
  (JHI on 1997-05-28)</option>
<option
  
  value="JHI/String-Approx-2.0_01"
>2.0_01 DEV
  (JHI on 1997-05-04)</option>
<option
  
  value="JHI/String-Approx-2.0"
>2.0
  (JHI on 1997-05-02)</option>
<option
  
  value="JHI/String-Approx-1.5"
>1.5
  (JHI on 1995-11-02)</option>
</optgroup>
</select>
    <a data-keyboard-shortcut="g d" class="release-name" href="https://metacpan.org/dist/String-Approx">String-Approx-3.28</a>
  </div>
<span class="river-gauge-gauge">
  <svg width="24px"
       height="15px"
       version="1.1"
       xmlns="http://www.w3.org/2000/svg"
       xmlns:xlink="http://www.w3.org/1999/xlink">

    <g>
      <title>        River stage one &#10;
          • 6 direct dependents &#10;          • 7 total dependents
      </title>

      <rect x="0"  y="0" width="4" height="15" fill="#7ea3f2" />
      <rect x="5"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="10"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="15"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="20"  y="0" width="4" height="15" fill="#e4e2e2" />
    </g>
  </svg>

</span>
<div id="String-Approx-fav" class="logged_in">
<form action="https://metacpan.org/account/favorite/add" style="display: inline" onsubmit="return favDistribution(this)">
    <input type="hidden" name="remove" value="0">
    <input type="hidden" name="release" value="String-Approx-3.28">
    <input type="hidden" name="author" value="JHI">
    <input type="hidden" name="distribution" value="String-Approx">
    <button type="submit" class="favorite highlight"><span>4</span> ++</button>
</form>
</div>
<div class="logged_out">
<a href="./String::Approx.html" onclick="alert('Please sign in to add favorites'); return false" class="favorite highlight">
<span>4</span> ++</a>
</div>
   / <span>String::Approx</span>
</div>
          </div>
          <main class="content">


<nav class="toc">
  <div class="toc-header"><strong>Contents</strong></div>
<ul>
  <li><a href="./String::Approx.html#NAME">NAME</a></li>
  <li><a href="./String::Approx.html#SYNOPSIS">SYNOPSIS</a></li>
  <li><a href="./String::Approx.html#DESCRIPTION">DESCRIPTION</a></li>
  <li><a href="./String::Approx.html#MATCH">MATCH</a>
    <ul>
      <li><a href="./String::Approx.html#MODIFIERS">MODIFIERS</a></li>
    </ul>
  </li>
  <li><a href="./String::Approx.html#SUBSTITUTE">SUBSTITUTE</a></li>
  <li><a href="./String::Approx.html#INDEX">INDEX</a></li>
  <li><a href="./String::Approx.html#SLICE">SLICE</a></li>
  <li><a href="./String::Approx.html#DISTANCE">DISTANCE</a></li>
  <li><a href="./String::Approx.html#CONTROLLING-THE-CACHE">CONTROLLING THE CACHE</a></li>
  <li><a href="./String::Approx.html#NOTES">NOTES</a>
    <ul>
      <li><a href="./String::Approx.html#TEXT-POSITION">TEXT POSITION</a></li>
    </ul>
  </li>
  <li><a href="./String::Approx.html#VERSION">VERSION</a></li>
  <li><a href="./String::Approx.html#CHANGES-FROM-VERSION-2">CHANGES FROM VERSION 2</a>
    <ul>
      <li><a href="./String::Approx.html#GOOD-NEWS">GOOD NEWS</a></li>
      <li><a href="./String::Approx.html#BAD-NEWS">BAD NEWS</a></li>
    </ul>
  </li>
  <li><a href="./String::Approx.html#ACKNOWLEDGEMENTS">ACKNOWLEDGEMENTS</a></li>
  <li><a href="./String::Approx.html#AUTHOR">AUTHOR</a></li>
  <li><a href="./String::Approx.html#COPYRIGHT-AND-LICENSE">COPYRIGHT AND LICENSE</a></li>
</ul></nav>
<div class="pod anchors">
<h1 id="NAME">NAME</h1>

<p>String::Approx - Perl extension for approximate matching (fuzzy matching)</p>

<h1 id="SYNOPSIS">SYNOPSIS</h1>

<pre><code>  use String::Approx &#39;amatch&#39;;

  print if amatch(&quot;foobar&quot;);

  my @matches = amatch(&quot;xyzzy&quot;, @inputs);

  my @catches = amatch(&quot;plugh&quot;, [&#39;2&#39;], @inputs);</code></pre>

<h1 id="DESCRIPTION">DESCRIPTION</h1>

<p>String::Approx lets you match and substitute strings approximately. With this you can emulate errors: typing errorrs, speling errors, closely related vocabularies (colour color), genetic mutations (GAG ACT), abbreviations (McScot, MacScot).</p>

<p>NOTE: String::Approx suits the task of <b>string matching</b>, not <b>string comparison</b>, and it works for <b>strings</b>, not for <b>text</b>.</p>

<p>If you want to compare strings for similarity, you probably just want the Levenshtein edit distance (explained below), the Text::Levenshtein and Text::LevenshteinXS modules in CPAN. See also Text::WagnerFischer and Text::PhraseDistance. (There are functions for this in String::Approx, e.g. adist(), but their results sometimes differ from the bare Levenshtein et al.)</p>

<p>If you want to compare things like text or source code, consisting of <b>words</b> or <b>tokens</b> and <b>phrases</b> and <b>sentences</b>, or <b>expressions</b> and <b>statements</b>, you should probably use some other tool than String::Approx, like for example the standard UNIX diff(1) tool, or the Algorithm::Diff module from CPAN.</p>

<p>The measure of <b>approximateness</b> is the <i>Levenshtein edit distance</i>. It is the total number of &quot;edits&quot;: insertions,</p>

<pre><code>        word world</code></pre>

<p>deletions,</p>

<pre><code>        monkey money</code></pre>

<p>and substitutions</p>

<pre><code>        sun fun</code></pre>

<p>required to transform a string to another string. For example, to transform <i>&quot;lead&quot;</i> into <i>&quot;gold&quot;</i>, you need three edits:</p>

<pre><code>        lead gead goad gold</code></pre>

<p>The edit distance of &quot;lead&quot; and &quot;gold&quot; is therefore three, or 75%.</p>

<p><b>String::Approx</b> uses the Levenshtein edit distance as its measure, but String::Approx is not well-suited for comparing strings of different length, in other words, if you want a &quot;fuzzy eq&quot;, see above. String::Approx is more like regular expressions or index(), it finds substrings that are close matches.&gt;</p>

<h1 id="MATCH">MATCH</h1>

<pre><code>        use String::Approx &#39;amatch&#39;;

        $matched     = amatch(&quot;pattern&quot;) 
        $matched     = amatch(&quot;pattern&quot;, [ modifiers ])

        $any_matched = amatch(&quot;pattern&quot;, @inputs) 
        $any_matched = amatch(&quot;pattern&quot;, [ modifiers ], @inputs)

        @match       = amatch(&quot;pattern&quot;) 
        @match       = amatch(&quot;pattern&quot;, [ modifiers ])

        @matches     = amatch(&quot;pattern&quot;, @inputs) 
        @matches     = amatch(&quot;pattern&quot;, [ modifiers ], @inputs)</code></pre>

<p>Match <b>pattern</b> approximately. In list context return the matched <b>@inputs</b>. If no inputs are given, match against the <b>$_</b>. In scalar context return true if <i>any</i> of the inputs match, false if none match.</p>

<p>Notice that the pattern is a string. Not a regular expression. None of the regular expression notations (^, ., *, and so on) work. They are characters just like the others. Note-on-note: some limited form of <i>&quot;regular expressionism&quot;</i> is planned in future: for example character classes ([abc]) and <i>any-chars</i> (.). But that feature will be turned on by a special <i>modifier</i> (just a guess: &quot;r&quot;), so there should be no backward compatibility problem.</p>

<p>Notice also that matching is not symmetric. The inputs are matched against the pattern, not the other way round. In other words: the pattern can be a substring, a submatch, of an input element. An input element is always a superstring of the pattern.</p>

<h2 id="MODIFIERS">MODIFIERS</h2>

<p>With the modifiers you can control the amount of approximateness and certain other control variables. The modifiers are one or more strings, for example <b>&quot;i&quot;</b>, within a string optionally separated by whitespace. The modifiers are inside an anonymous array: the <b>[ ]</b> in the syntax are not notational, they really do mean <b>[ ]</b>, for example <b>[ &quot;i&quot;, &quot;2&quot; ]</b>. <b>[&quot;2 i&quot;]</b> would be identical.</p>

<p>The implicit default approximateness is 10%, rounded up. In other words: every tenth character in the pattern may be an error, an edit. You can explicitly set the maximum approximateness by supplying a modifier like</p>

<pre><code>        number
        number%</code></pre>

<p>Examples: <b>&quot;3&quot;</b>, <b>&quot;15%&quot;</b>.</p>

<p>Note that <code>0%</code> is not rounded up, it is equal to <code>0</code>.</p>

<p>Using a similar syntax you can separately control the maximum number of insertions, deletions, and substitutions by prefixing the numbers with I, D, or S, like this:</p>

<pre><code>        Inumber
        Inumber%
        Dnumber
        Dnumber%
        Snumber
        Snumber%</code></pre>

<p>Examples: <b>&quot;I2&quot;</b>, <b>&quot;D20%&quot;</b>, <b>&quot;S0&quot;</b>.</p>

<p>You can ignore case (<b>&quot;A&quot;</b> becames equal to <b>&quot;a&quot;</b> and vice versa) by adding the <b>&quot;i&quot;</b> modifier.</p>

<p>For example</p>

<pre><code>        [ &quot;i 25%&quot;, &quot;S0&quot; ]</code></pre>

<p>means <i>ignore case</i>, <i>allow every fourth character to be &quot;an edit&quot;</i>, but allow <i>no substitutions</i>. (See <a href="https://metacpan.org/pod/NOTES">NOTES</a> about disallowing substitutions or insertions.)</p>

<p>NOTE: setting <code>I0 D0 S0</code> is not equivalent to using index(). If you want to use index(), use index().</p>

<h1 id="SUBSTITUTE">SUBSTITUTE</h1>

<pre><code>        use String::Approx &#39;asubstitute&#39;;

        @substituted = asubstitute(&quot;pattern&quot;, &quot;replacement&quot;)
        @substituted = asubstitute(&quot;pattern&quot;, &quot;replacement&quot;, @inputs) 
        @substituted = asubstitute(&quot;pattern&quot;, &quot;replacement&quot;, [ modifiers ])
        @substituted = asubstitute(&quot;pattern&quot;, &quot;replacement&quot;,
                                   [ modifiers ], @inputs)</code></pre>

<p>Substitute approximate <b>pattern</b> with <b>replacement</b> and return as a list &lt;copies&gt; of <b>@inputs</b>, the substitutions having been made on the elements that did match the pattern. If no inputs are given, substitute in the <b>$_</b>. The replacement can contain magic strings <b>$&amp;</b>, <b>$`</b>, <b>$&#39;</b> that stand for the matched string, the string before it, and the string after it, respectively. All the other arguments are as in <code>amatch()</code>, plus one additional modifier, <b>&quot;g&quot;</b> which means substitute globally (all the matches in an element and not just the first one, as is the default).</p>

<p>See <a href="./String::Approx.html#BAD-NEWS">&quot;BAD NEWS&quot;</a> about the unfortunate stinginess of <code>asubstitute()</code>.</p>

<h1 id="INDEX">INDEX</h1>

<pre><code>        use String::Approx &#39;aindex&#39;;

        $index   = aindex(&quot;pattern&quot;)
        @indices = aindex(&quot;pattern&quot;, @inputs)
        $index   = aindex(&quot;pattern&quot;, [ modifiers ])
        @indices = aindex(&quot;pattern&quot;, [ modifiers ], @inputs)</code></pre>

<p>Like <code>amatch()</code> but returns the index/indices at which the pattern matches approximately. In list context and if <code>@inputs</code> are used, returns a list of indices, one index for each input element. If there&#39;s no approximate match, <code>-1</code> is returned as the index.</p>

<p>NOTE: if there is character repetition (e.g. &quot;aa&quot;) either in the pattern or in the text, the returned index might start &quot;too early&quot;. This is consistent with the goal of the module of matching &quot;as early as possible&quot;, just like regular expressions (that there might be a &quot;less approximate&quot; match starting later is of somewhat irrelevant).</p>

<p>There&#39;s also backwards-scanning <code>arindex()</code>.</p>

<h1 id="SLICE">SLICE</h1>

<pre><code>        use String::Approx &#39;aslice&#39;;

        ($index, $size)   = aslice(&quot;pattern&quot;)
        ([$i0, $s0], ...) = aslice(&quot;pattern&quot;, @inputs)
        ($index, $size)   = aslice(&quot;pattern&quot;, [ modifiers ])
        ([$i0, $s0], ...) = aslice(&quot;pattern&quot;, [ modifiers ], @inputs)</code></pre>

<p>Like <code>aindex()</code> but returns also the size (length) of the match. If the match fails, returns an empty list (when matching against <code>$_</code>) or an empty anonymous list corresponding to the particular input.</p>

<p>NOTE: size of the match will very probably be something you did not expect (such as longer than the pattern, or a negative number). This may or may not be fixed in future releases. Also the beginning of the match may vary from the expected as with aindex(), see above.</p>

<p>If the modifier</p>

<pre><code>        &quot;minimal_distance&quot;</code></pre>

<p>is used, the minimal possible edit distance is returned as the third element:</p>

<pre><code>        ($index, $size, $distance) = aslice(&quot;pattern&quot;, [ modifiers ])
        ([$i0, $s0, $d0], ...)     = aslice(&quot;pattern&quot;, [ modifiers ], @inputs)</code></pre>

<h1 id="DISTANCE">DISTANCE</h1>

<pre><code>        use String::Approx &#39;adist&#39;;

        $dist = adist(&quot;pattern&quot;, $input);
        @dist = adist(&quot;pattern&quot;, @input);</code></pre>

<p>Return the <i>edit distance</i> or distances between the pattern and the input or inputs. Zero edit distance means exact match. (Remember that the match can &#39;float&#39; in the inputs, the match is a substring match.) If the pattern is longer than the input or inputs, the returned distance or distances is or are negative.</p>

<pre><code>        use String::Approx &#39;adistr&#39;;

        $dist = adistr(&quot;pattern&quot;, $input);
        @dist = adistr(&quot;pattern&quot;, @inputs);</code></pre>

<p>Return the <b>relative</b> <i>edit distance</i> or distances between the pattern and the input or inputs. Zero relative edit distance means exact match, one means completely different. (Remember that the match can &#39;float&#39; in the inputs, the match is a substring match.) If the pattern is longer than the input or inputs, the returned distance or distances is or are negative.</p>

<p>You can use adist() or adistr() to sort the inputs according to their approximateness:</p>

<pre><code>        my %d;
        @d{@inputs} = map { abs } adistr(&quot;pattern&quot;, @inputs);
        my @d = sort { $d{$a} &lt;=&gt; $d{$b} } @inputs;</code></pre>

<p>Now <code>@d</code> contains the inputs, the most like <code>&quot;pattern&quot;</code> first.</p>

<h1 id="CONTROLLING-THE-CACHE"><a id="CONTROLLING"></a>CONTROLLING THE CACHE</h1>

<p><code>String::Approx</code> maintains a LU (least-used) cache that holds the &#39;matching engines&#39; for each instance of a <i>pattern+modifiers</i>. The cache is intended to help the case where you match a small set of patterns against a large set of string. However, the more engines you cache the more you eat memory. If you have a lot of different patterns or if you have a lot of memory to burn, you may want to control the cache yourself. For example, allowing a larger cache consumes more memory but probably runs a little bit faster since the cache fills (and needs flushing) less often.</p>

<p>The cache has two parameters: <i>max</i> and <i>purge</i>. The first one is the maximum size of the cache and the second one is the cache flushing ratio: when the number of cache entries exceeds <i>max</i>, <i>max</i> times <i>purge</i> cache entries are flushed. The default values are 1000 and 0.75, respectively, which means that when the 1001st entry would be cached, 750 least used entries will be removed from the cache. To access the parameters you can use the calls</p>

<pre><code>        $now_max = String::Approx::cache_max();
        String::Approx::cache_max($new_max);

        $now_purge = String::Approx::cache_purge();
        String::Approx::cache_purge($new_purge);

        $limit = String::Approx::cache_n_purge();</code></pre>

<p>To be honest, there are actually <b>two</b> caches: the first one is used far the patterns with no modifiers, the second one for the patterns with pattern modifiers. Using the standard parameters you will therefore actually cache up to 2000 entries. The above calls control both caches for the same price.</p>

<p>To disable caching completely use</p>

<pre><code>        String::Approx::cache_disable();</code></pre>

<p>Note that this doesn&#39;t flush any possibly existing cache entries, to do that use</p>

<pre><code>        String::Approx::cache_flush_all();</code></pre>

<h1 id="NOTES">NOTES</h1>

<p>Because matching is by <i>substrings</i>, not by whole strings, insertions and substitutions produce often very similar results: &quot;abcde&quot; matches &quot;axbcde&quot; either by insertion <b>or</b> substitution of &quot;x&quot;.</p>

<p>The maximum edit distance is also the maximum number of edits. That is, the <b>&quot;I2&quot;</b> in</p>

<pre><code>        amatch(&quot;abcd&quot;, [&quot;I2&quot;])</code></pre>

<p>is useless because the maximum edit distance is (implicitly) 1. You may have meant to say</p>

<pre><code>        amatch(&quot;abcd&quot;, [&quot;2D1S1&quot;])</code></pre>

<p>or something like that.</p>

<p>If you want to simulate transposes</p>

<pre><code>        feet fete</code></pre>

<p>you need to allow at least edit distance of two because in terms of our edit primitives a transpose is first one deletion and then one insertion.</p>

<h2 id="TEXT-POSITION"><a id="TEXT"></a>TEXT POSITION</h2>

<p>The starting and ending positions of matching, substituting, indexing, or slicing can be changed from the beginning and end of the input(s) to some other positions by using either or both of the modifiers</p>

<pre><code>        &quot;initial_position=24&quot;
        &quot;final_position=42&quot;</code></pre>

<p>or the both the modifiers</p>

<pre><code>        &quot;initial_position=24&quot;
        &quot;position_range=10&quot;</code></pre>

<p>By setting the <b>&quot;position_range&quot;</b> to be zero you can limit (anchor) the operation to happen only once (if a match is possible) at the position.</p>

<h1 id="VERSION">VERSION</h1>

<p>Major release 3.</p>

<h1 id="CHANGES-FROM-VERSION-2"><a id="CHANGES"></a>CHANGES FROM VERSION 2</h1>

<h2 id="GOOD-NEWS"><a id="GOOD"></a>GOOD NEWS</h2>

<dl>

<dt id="The-version-3-is-2-3-times-faster-than-version-2"><a id="The"></a>The version 3 is 2-3 times faster than version 2</dt>
<dd>

</dd>
<dt id="No-pattern-length-limitation"><a id="No"></a>No pattern length limitation</dt>
<dd>

<p>The algorithm is independent on the pattern length: its time complexity is <i>O(kn)</i>, where <i>k</i> is the number of edits and <i>n</i> the length of the text (input). The preprocessing of the pattern will of course take some <i>O(m)</i> (<i>m</i> being the pattern length) time, but <code>amatch()</code> and <code>asubstitute()</code> cache the result of this preprocessing so that it is done only once per pattern.</p>

</dd>
</dl>

<h2 id="BAD-NEWS"><a id="BAD"></a>BAD NEWS</h2>

<dl>

<dt id="You-do-need-a-C-compiler-to-install-the-module"><a id="You"></a>You do need a C compiler to install the module</dt>
<dd>

<p>Perl&#39;s regular expressions are no more used; instead a faster and more scalable algorithm written in C is used.</p>

</dd>
<dt id="asubstitute()-is-now-always-stingy"><a id="asubstitute"></a><a id="asubstitute--is-now-always-stingy"></a><code>asubstitute()</code> is now always stingy</dt>
<dd>

<p>The string matched and substituted is now always stingy, as short as possible. It used to be as long as possible. This is an unfortunate change stemming from switching the matching algorithm. Example: with edit distance of two and substituting for <b>&quot;word&quot;</b> from <b>&quot;cork&quot;</b> and <b>&quot;wool&quot;</b> previously did match <b>&quot;cork&quot;</b> and <b>&quot;wool&quot;</b>. Now it does match <b>&quot;or&quot;</b> and <b>&quot;wo&quot;</b>. As little as possible, or, in other words, with as much approximateness, as many edits, as possible. Because there is no <i>need</i> to match the <b>&quot;c&quot;</b> of <b>&quot;cork&quot;</b>, it is not matched.</p>

</dd>
<dt id="no-more-aregex()-because-regular-expressions-are-no-more-used"><a id="no"></a><a id="no-more-aregex--because-regular-expressions-are-no-more-used"></a>no more <code>aregex()</code> because regular expressions are no more used</dt>
<dd>

</dd>
<dt id="no-more-compat1-for-String::Approx-version-1-compatibility"><a id="no1"></a>no more <code>compat1</code> for String::Approx version 1 compatibility</dt>
<dd>

</dd>
</dl>

<h1 id="ACKNOWLEDGEMENTS">ACKNOWLEDGEMENTS</h1>

<p>The following people have provided valuable test cases, documentation clarifications, and other feedback:</p>

<p>Jared August, Arthur Bergman, Anirvan Chatterjee, Steve A. Chervitz, Aldo Calpini, David Curiel, Teun van den Dool, Alberto Fontaneda, Rob Fugina, Dmitrij Frishman, Lars Gregersen, Kevin Greiner, B. Elijah Griffin, Mike Hanafey, Mitch Helle, Ricky Houghton, &#39;idallen&#39;, Helmut Jarausch, Damian Keefe, Ben Kennedy, Craig Kelley, Franz Kirsch, Dag Kristian, Mark Land, J. D. Laub, John P. Linderman, Tim Maher, Juha Muilu, Sergey Novoselov, Andy Oram, Ji Y Park, Eric Promislow, Nikolaus Rath, Stefan Ram, Slaven Rezic, Dag Kristian Rognlien, Stewart Russell, Slaven Rezic, Chris Rosin, Pasha Sadri, Ilya Sandler, Bob J.A. Schijvenaars, Ross Smith, Frank Tobin, Greg Ward, Rich Williams, Rick Wise.</p>

<p>The matching algorithm was developed by Udi Manber, Sun Wu, and Burra Gopal in the Department of Computer Science, University of Arizona.</p>

<h1 id="AUTHOR">AUTHOR</h1>

<p>Jarkko Hietaniemi &lt;jhi@iki.fi&gt;</p>

<h1 id="COPYRIGHT-AND-LICENSE"><a id="COPYRIGHT"></a>COPYRIGHT AND LICENSE</h1>

<p>Copyright 2001-2013 by Jarkko Hietaniemi</p>

<p>This library is free software; you can redistribute it and/or modify under either the terms of the Artistic License 2.0, or the GNU Library General Public License, Version 2. See the files Artistic and LGPL for more details.</p>

<p>Furthermore: no warranties or obligations of any kind are given, and the separate file <i>COPYRIGHT</i> must be included intact in all copies and derived materials.</p></div>

<div id="metacpan_install-instructions-dialog" class="modal fade">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
        <h4 class="modal-title">Module Install Instructions</h4>
      </div>
      <div class="modal-body">
        <p>To install String::Approx, copy and paste the appropriate command in to your terminal.</p>
        <p><a href="https://metacpan.org/dist/App-cpanminus/view/bin/cpanm">cpanm</a></p>
        <pre><code>cpanm String::Approx</code></pre>
        <p><a href="https://metacpan.org/pod/CPAN">CPAN shell</a></p>
        <pre><code>perl -MCPAN -e shell
install String::Approx</code></pre>
        <p>For more information on module installation, please visit <a href="https://www.cpan.org/modules/INSTALL.html">the detailed CPAN module installation guide</a>.</p>
      </div>
      <div class="modal-footer">
        <a href="./String::Approx.html#" data-dismiss="modal" class="btn">Close</a>
      </div>
    </div>
  </div>
</div>
          </main>
          <div class="content-pagination">
          </div>
        </div>
        <footer class="footer">
          <div class="footer-container">
            <div class="footer-social">
              <div class="footer-link footer-logo">
                <a href="https://metacpan.org/">
                  <img src="https://metacpan.org/static/images/metacpan-logo.svg" alt="MetaCPAN" />
                </a>
              </div>
              <a class="footer-social-link" href="https://github.com/metacpan">
                <i class="fab fa-github-square"></i>
              </a>
              <a class="footer-social-link" href="https://fosstodon.org/@metacpan">
                <i class="fab fa-mastodon"></i>
              </a>
            </div>
            <div class="footer-links">
              <div class="footer-link">
                  <a href="https://metacpan.org/about">About</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/sponsors">Sponsor</a>
              </div>
              <div class="footer-link">
                  <a href="https://grep.metacpan.org">grep::cpan</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/recent">Recent</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/faq">FAQ</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/tools">Tools</a>
              </div>
              <div class="footer-link">
                  <a href="https://fastapi.metacpan.org/">API</a>
              </div>
              <div class="footer-link">
                  <a href="https://www.perl.org/">Perl.org</a>
              </div>
            </div>
            <div class="footer-sponsors">
              <a class="footer-sponsor-link" target="_blank" href="https://www.bytemark.co.uk/" rel="noopener">
                <img class="footer-sponsor-bytemark" src="https://metacpan.org/static/images/sponsors/bytemark_logo.svg" alt="Bytemark logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.liquidweb.com/" rel="noopener">
                <img class="footer-sponsor-liquidweb" src="https://metacpan.org/static/images/sponsors/liquidweb_logo.png" alt="liquidweb logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://deriv.com/careers/" rel="noopener">
                <img class="footer-sponsor-deriv" src="https://metacpan.org/static/images/sponsors/deriv.svg" alt="Deriv logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://geocode.xyz" rel="noopener">
                <img class="footer-sponsor-geocode" src="https://metacpan.org/static/images/sponsors/geocodelogo.svg" alt="Geocode logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.fastly.com/" rel="noopener">
                <img class="footer-sponsor-fastly" src="https://metacpan.org/static/images/sponsors/fastly_logo.svg" alt="Fastly logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://opencagedata.com" rel="noopener">
                <img class="footer-sponsor-opencage" src="https://metacpan.org/static/images/sponsors/open-cage.svg" alt="OpenCage logo">
              </a>
            </div>
          </div>
        </footer>
        <div class="modal fade" tabindex="-1" role="dialog" id="metacpan_keyboard-shortcuts">
          <div class="modal-dialog">
            <div class="modal-content">
              <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal">&times;</button>
                <h4 class="modal-title">Keyboard Shortcuts</h4>
              </div>
              <div class="modal-body row">
<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Global</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>s</kbd>
        </td>
        <td>Focus search bar</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>?</kbd>
        </td>
        <td>Bring up this help dialog</td>
      </tr>
    </tbody>
  </table>

  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>GitHub</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>p</kbd>
        </td>
        <td>Go to pull requests</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>go to github issues (only if github is preferred repository)</td>
      </tr>
    </tbody>
  </table>
</div>

<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>POD</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>a</kbd>
        </td>
        <td>Go to author</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>c</kbd>
        </td>
        <td>Go to changes</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>Go to issues</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>d</kbd>
        </td>
        <td>Go to dist</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>r</kbd>
        </td>
        <td>Go to repository/SCM</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>s</kbd>
        </td>
        <td>Go to source</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>b</kbd>
        </td>
        <td>Go to file browse</td>
      </tr>

    </tbody>
  </table>
</div>

<div class="col-md-12">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Search terms</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td><em>module:</em> (e.g. <a href="https://metacpan.org/search?q=module%3APlugin">module:Plugin</a>)</td>
      </tr>
      <tr>
        <td><em>distribution:</em> (e.g. <a href="https://metacpan.org/search?q=distribution%3ADancer+auth">distribution:Dancer auth</a>)</td>
      </tr>
      <tr>
        <td><em>author:</em> (e.g. <a href="https://metacpan.org/search?q=author%3ASONGMU+Redis">author:SONGMU Redis</a>)</td>
      </tr>
      <tr>
        <td><em>version:</em> (e.g. <a href="https://metacpan.org/search?q=version%3A1.00">version:1.00</a>)</td>
      </tr>
    </tbody>
  </table>
</div>
              </div>
              <div class="modal-footer"></div>
            </div>
          </div>
        </div>
    </body>
</html>
